home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / euphor13.zip / README.DOC < prev    next >
Text File  |  1995-05-16  |  9KB  |  192 lines
  1.             --------------------
  2.             Euphoria version 1.3
  3.             --------------------
  4.  
  5.  Welcome to Euphoria! ... End User Programming with Hierarchical Objects
  6.               for Robust Interpreted Applications
  7.  
  8.  Euphoria is a very-high-level programming language with the following 
  9.  features: 
  10.  
  11.     * The language is extremely simple, flexible, and easier to learn 
  12.       than BASIC.
  13.  
  14.     * There is no waiting for compiles and links - just edit and run. 
  15.  
  16.     * Dynamic storage allocation with garbage collection is fundamental
  17.       to Euphoria. Variables can easily grow or shrink in size. Elements 
  18.       of an array (Euphoria sequence) can be a dynamic mixture of 
  19.       different types and sizes of data.
  20.  
  21.     * Variable types can be as rigid or as flexible as you like. You can 
  22.       specify the precise set of legal values that may be assigned to 
  23.       any variable. You can easily write generic code that works on any 
  24.       type of data.
  25.  
  26.     * Euphoria provides extensive run-time error checking for: 
  27.       out-of-bounds subscripts, uninitialized variables, bad parameter 
  28.       values for built-in functions, illegal value assigned to a variable,
  29.       and many more. If something goes wrong with your program you will
  30.       always get a full message with a traceback and a dump of variable 
  31.       values - no mysterious machine "lockups" or crashes.
  32.  
  33.     * Program execution speed is 10 to 20 times faster than 
  34.       Microsoft QBasic, and only a few times slower than compiled, 
  35.       optimized C/C++ -- an astonishing fact, given the flexibility, 
  36.       run-time safety and interpretive nature of the language.
  37.  
  38.     * Euphoria programs are not constrained by any 640K or 64K memory 
  39.       restrictions for which MS-DOS is infamous. You can use all of the 
  40.       multiple megabytes of extended memory on your system seamlessly,
  41.        and if that isn't enough you can use a swap file on disk to page
  42.       chunks of memory in and out based on a least-recently-used 
  43.       algorithm.
  44.  
  45.     * An integrated easy-to-use full-screen source-level debugger/tracer 
  46.       is included.
  47.  
  48.     * A statement-level profiler is included.
  49.  
  50.     * A full-screen, multi-file editor with color syntax highlighting and 
  51.       auto-completion of Euphoria statements is provided, complete
  52.       with Euphoria source code that you are free to modify.
  53.  
  54.     * A large collection of interesting demo programs written in Euphoria
  55.       is provided.
  56.  
  57.  Who would benefit from using Euphoria?
  58.  
  59.      * novices / students
  60.         - Euphoria is one of the simplest and easiest of all 
  61.           languages to learn.
  62.         - Euphoria completely shields you from machine-level
  63.           issues such as memory addresses, number of bits in a byte 
  64.           etc.
  65.         - Euphoria does more error checking than any other
  66.           popular language.            
  67.         - Euphoria never leaves you with a crashed machine - 
  68.           you'll always get a clear explanation of what went wrong
  69.  
  70.     * hobbyists 
  71.         - take a look at some of the interesting games and
  72.           high-speed graphics demos we've included.
  73.         - do you really want to invest the time and money
  74.           needed to learn C++?
  75.         - do you really enjoy spending your weekends tracking
  76.           down subtle pointer corruption bugs?
  77.         
  78.     * professionals/businesses 
  79.         - You can develop a reliable, maintainable, fully-
  80.           debugged program in *much* less time in Euphoria
  81.           than in C/C++.  
  82.         - The level of experience and machine knowledge required
  83.           to use Euphoria is much lower than for C/C++. You won't
  84.           have to hire high-priced programmers. You can do the job
  85.           yourself, or hire lower-priced people.
  86.         - take a look at include\sort.e. Can you write a 
  87.           generic routine this easily in C++?
  88.         - See demo\mydata.ex. Can you set up a simple database this
  89.           easily in any other language? Or must you purchase an
  90.           expensive, complicated database management system that
  91.           can't really be customized to your liking?
  92.         - Euphoria can be used as a sophisticated batch file 
  93.           language. 
  94.         - Euphoria is great for quick, easy development of file 
  95.           filters and other utilities.
  96.  
  97.  Euphoria comes in two different editions: a Public Domain Edition and a
  98.  Complete Edition. Both editions will run any Euphoria program of any size at
  99.  full speed, and will report all "compile-time" errors such as syntax errors,
  100.  undeclared variables etc. The only restriction in the Public Domain Edition 
  101.  is that full diagnostic information for run-time errors is not provided
  102.  for large programs.
  103.  
  104.  For programs up to 50 executable statements in size you will enjoy the full 
  105.  support of Euphoria's excellent debugging facilities. Your program can have 
  106.  an infinite number of declarations, blank-lines, comments, "end if", etc.
  107.  -- they aren't counted. The standard include files are also free. 
  108.  
  109.  For larger programs, a run-time error will cause your program to halt
  110.  with just a brief message. The usual fully-detailed diagnostics with a dump
  111.  of variable values and other debugging information will not be provided.
  112.  However, the source debugger and profiler will remain fully operational,
  113.  and you can insert debug print statements the way you would in C/C++ or other 
  114.  languages. In C/C++ very few run-time errors are even detected (until your 
  115.  machine locks up, crashes, or you get a "GPF"). Your productivity will remain
  116.  much higher in Euphoria, given the run-time safety, flexibility and expressive 
  117.  power of the language, plus the fact that you won't waste time compiling and
  118.  linking.  
  119.  
  120.  We want you to enjoy writing some great programs in Euphoria. When you 
  121.  decide that you like the language, and want to save time developing 
  122.  large programs, we hope you will decide to purchase the latest Complete 
  123.  Edition and the desktop-published printed manual. See doc\register.doc for 
  124.  details.
  125.  
  126.  An ASCII text version of the complete Euphoria Reference Manual is in 
  127.  doc\refman.doc and doc\library.doc. 
  128.  
  129.  You are free to distribute the Public Domain Edition, without royalty, so 
  130.  anyone can run a Euphoria program that you have developed. The Rational 
  131.  Systems DOS-extender, "dos4gw.exe", required by Euphoria, is also 
  132.  royalty-free when used with Euphoria. Use bin\shroud.ex to create Euphoria's
  133.  equivalent to a DOS .exe file. 
  134.  
  135.  You may *not* distribute the Complete Edition, in particular the version of 
  136.  the file "ex.exe" that comes with the Complete Edition.
  137.  
  138.  The Public Domain Edition of Euphoria, in its entirety, is being placed 
  139.  in the Public Domain. This includes the Public Domain version of the 
  140.  compiler/interpreter "ex.exe" and all of the demo programs, including the 
  141.  editor. There's over 13,000 lines of free Euphoria source code in
  142.  this package. We encourage you to use it, copy it, distribute it, upload it 
  143.  to BBS's etc. 
  144.  
  145.  To run Euphoria you must have MS-DOS on any 386 or higher processor.
  146.  Euphoria runs comfortably on any 2 Mb PC that has at least 350K of 
  147.  free extended memory. It has been well tested under MS-DOS 4, 5, 6 and 
  148.  6.2, Windows 3.1, Windows 3.11, Windows NT and OS/2. If the Public Domain 
  149.  Edition runs on your machine, the Complete Edition will also run. Euphoria
  150.  exploits the full 32-bit power of your PC. A Euphoria program will run under
  151.  DOS, or as a DOS application under Windows or OS/2 - just double-click on the
  152.  file name, or open a DOS prompt window.
  153.  
  154.  What's in this Public Domain release:
  155.  
  156.     subdirectory (after installing)
  157.     BIN        - Euphoria (ex.exe), search, lines, eprint, and more 
  158.  
  159.     INCLUDE    - standard .e include files
  160.  
  161.     DEMO       - games, benchmarks and other Euphoria programs that
  162.              you can run to check out Euphoria
  163.  
  164.            LANGWAR - real-time action space wars game
  165.            BENCH   - benchmark programs and results
  166.  
  167.     DOC        documentation files, including the complete Reference Manual
  168.  
  169.  You can run some of the programs without installing Euphoria, but you really
  170.  should run install.bat to organize the files into subdirectories and
  171.  set yourself up properly. Some programs will not run until you have
  172.  installed.
  173.  
  174.      *** See INSTALL.DOC for easy instructions on installing Euphoria ***
  175.  
  176. ----------------------------------------------------------------------------
  177.   Notice to Shareware Vendors:
  178.   We encourage you to distribute this Public Domain Edition of Euphoria.
  179.   You can charge whatever you like for it. It is not shareware in the
  180.   usual sense. People can use Euphoria for as long as they like without
  181.   obligation. We make money from those who start to seriously develop large 
  182.   applications, and want to get the latest release, with printed manual, 
  183.   and enhanced debug support for large programs.
  184. ----------------------------------------------------------------------------
  185.  
  186. ----------------------------------------------------------------------------
  187.   DISCLAIMER: The Public Domain and Complete Editions of Euphoria are
  188.   provided "as is" without warranty of any kind. In no event shall 
  189.   Rapid Deployment Software be held liable for any damages arising 
  190.   from the use of or inability to use this product.
  191. ----------------------------------------------------------------------------
  192.